home *** CD-ROM | disk | FTP | other *** search
/ BMUG PD-ROM A / PD-ROM A.iso / Telecom / Terminal Programs / CTerm / CTerm Information < prev   
Encoding:
Text File  |  1991-12-29  |  9.9 KB  |  349 lines  |  [TEXT/ttxt]
  1.  
  2.  
  3.  
  4.  
  5. CTerm 2.0
  6.  
  7.  
  8.  
  9. Copyright © 1991 by Michael Niehaus
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25. This is a shareware product.  If you find it useful, please register your copy by 
  26. sending $20 to one of the addresses below.  This will enable me to send you 
  27. information on improvements that I may add to the program and bugs I may fix.  
  28. (Upgrades are free, as long as you download them from an on-line service.  For a 
  29. copy of the most recent version, send me $5 and I will send a copy to you.)
  30.  
  31.  
  32. If you have any comments, suggestions, etc., feel free to contact me by phone,  
  33. electronic mail, or the postal service:
  34.  
  35.  
  36.     Michael Niehaus                Michael Niehaus
  37.  
  38.     733 Longmeadow Lane Apt. 8        Rural Route 1 Box 369
  39.  
  40.     Findlay, OH 45840                Ferdinand, IN 47532
  41.  
  42.     (419) 425-3032
  43.  
  44.     UUCP: mithomas@bsu-cs.bsu.edu
  45.  
  46.     Compuserve: 73760,171
  47.  
  48.  
  49. If you have problems, let me know and I will see to it that they are resolved if possible.  
  50. If CTerm does not meet your needs, let me know why.
  51.  
  52.  
  53. I will normally return phone calls.  However, since the phone calls outnumber the 
  54. registrations by about a 20 to 1 ratio, this is a losing proposition on my part and may 
  55. not be continued in the future.
  56.  
  57.  
  58.  
  59.  
  60.  
  61. Introduction
  62.  
  63.  
  64.     This is version 2.0 of CTerm, a package designed to let a Macintosh talk to an 
  65. IBM mainframe though an IBM (or compatible) protocol converter by 
  66. emulating an asynchronous 3270 terminal (as does IBM’s PC/Host 
  67. [FTTERM] software).
  68.  
  69.  
  70.     The following protocol converters (and any others that are compatible) should 
  71. be compatible with CTerm:
  72.  
  73.  
  74. IBM 3174 Subsystem Controller with the Asynchronous Emulation 
  75. Adapter Feature (Terminal type FC or FM)
  76.  
  77. IBM 3708 Network Conversion Unit (Terminal type FTTerm Color or 
  78. FTTerm Mono)
  79.  
  80. IBM 3710 PA-8 Network Conversion Unit 
  81.  
  82. IBM 7171 ASCII Device Attachment Control Unit (Terminal type user-
  83. defined)
  84.  
  85. IBM 9370 ASCII Subsystem (Terminal type FTTERMC or FTTERMM)
  86.  
  87.  
  88.     Prior versions of CTerm did not properly send the function key codes to the 
  89. protocol converter when using IBM 7171 and 9370 protocol converters.  This 
  90. should be fixed in this version, although I do not have the equipment available 
  91. to verify this.  If this version still does not work properly on this equipment, 
  92. please let me know.
  93.  
  94.  
  95. Requirements
  96.  
  97.  
  98.     This program requires a Macintosh Plus or better.  Color support is achieved 
  99. using standard QuickDraw (not Color QuickDraw).  Memory requirements 
  100. are small (I currently have it set around 200K, but I am sure that it could safely 
  101. be lowered).  A single floppy is sufficient to run the program.  CTerm is System 
  102. 7.0-compatible.  Currently, System 6.0.5 or better is needed.  Version 2.1 
  103. may require System 7.0, so consider upgrading (it is definitely worthwhile).
  104.  
  105.  
  106.     The Communications Toolbox software must be obtained from APDA, 
  107. Apple Software Licensing, or any other approved source (such as 
  108. CompuServe) when using System 6.0.X.  The Communications Toolbox 
  109. is included in System 7.0.  However, no connection tools are provided.  
  110. These tools, the Basic Connectivity Set, can be obtained from APDA or 
  111. from an on-line source.
  112.  
  113.  
  114.     Some type of asynchronous connection to an IBM protocol converter (or 
  115. some other compatible protocol converter) is also required.  Normal 
  116. communications parameters appear to be even parity, seven data bits, one 
  117. stop bit, although this could differ from site to site.
  118.  
  119.  
  120.     This program has been tested at speeds up to 2400 baud, and should be able 
  121. to support higher speeds without any problems.
  122.  
  123.  
  124. Setup
  125.  
  126.  
  127.     With version 2.0 of CTerm, the name of the configuration file has changed.  The 
  128. old file was named “CTerm Config”; it is now called “CTerm Preferences”.
  129.  
  130.  
  131.     The first time you run this program (or this version), you will need to configure 
  132. the communication parameters.  These parameters are saved in the System 
  133. Folder in a file named “CTerm Preferences”.  If running under System 7.0, 
  134. this file will be placed in the Preferences folder.  (After upgrading to System 
  135. 7.0 you will need to move this file by hand for CTerm to be able to find it.  It will 
  136. not look in both places.)
  137.  
  138.  
  139.     The location of the terminal window is also saved in this configuration file.  By 
  140. default, the window is positioned in the upper left corner of the screen (so the 
  141. whole window can be seen on a small screen).  Be careful if running on 
  142. multiple machines, since the saved window position could be off the screen on 
  143. a different machine.
  144.  
  145.  
  146.     In addition to the communication parameters and terminal window location, 
  147. other information is saved, including the background color, emulation type, 
  148. font,  and font size.
  149.  
  150.  
  151.     For those inclined to use ResEdit, command keys on any menu may be 
  152. changed (including the pop-up key menu).  Also, additional fixed-width fonts 
  153. may be added to the font list contained in ‘STR#’ resource number 129.  (Fonts 
  154. not found in any standard point size will not be added to the menu even if they 
  155. are in this list.  Scaled or proportional fonts will not work properly.)
  156.  
  157.  
  158.     For best performance on color machines, use fonts that have the same depth 
  159. as the screen or that are marked “not to be expanded”  in the fontType field of 
  160. the font resource.  Speed increases are noticeable.  (One font that is well 
  161. suited is “TTYFont”, provided with the Basic Connectivity Set.)
  162.  
  163.  
  164.     Distribution of modified versions of this software is prohibited.
  165.  
  166.  
  167.     If you used any version of CTerm before, your old configuration file “CTerm 
  168. Config” will need to be deleted.  The contents and format of this file have 
  169. changed in this version, requiring a reconfiguration of the program.
  170.  
  171.  
  172. Features
  173.  
  174.  
  175.     Different background colors are now supported.  Select these from the 
  176. “Background Color” menu.  Be careful not to choose a color that matches the 
  177. color of any text on the screen -- the text would disappear.  (Black and white 
  178. are exceptions: if you make the background white, white text will become 
  179. black; if you make the background black, black text will become white.)
  180.  
  181.  
  182.     Note that on machines without color, all colors (except white) are converted to 
  183. black.  Therefore, white is the recommended background color for these 
  184. machines.  For others, black is recommended, mainly for unscientific 
  185. (aesthetic) reasons.
  186.  
  187.  
  188.     Function keys and special keys can be selected by holding down the Option 
  189. key and clicking on the title bar of the terminal window.  This replaces the 
  190. floating palette that was in version 1.03v2.
  191.  
  192.  
  193.     Printing the contents of the screen can now be accomplished by using the 
  194. “Print Screen” option in the “File” menu.  This should work for all printers, 
  195. although it has not been tested.  (Personally, I don’t own a printer.)
  196.  
  197.  
  198.     Cursor positioning can be achieved by holding down the Option key and 
  199. clicking on the location to which you want the cursor to move.  Notice that the 
  200. pointer will change into a transparent rectangle to help you determine where 
  201. the cursor will move when you click.
  202.  
  203.  
  204.     Copy and paste functions are supported.  When selecting the text that you 
  205. want to copy, the selection box will show the exact text that will be copied; no 
  206. guesswork is required.  Selections will always be rectangular, since that is the 
  207. most useful method in an IBM environment (to eliminate sequence numbers, 
  208. etc.).  To copy the full screen, do not select any text; just choose the “Copy” 
  209. menu item.
  210.  
  211.  
  212.     Support for both monochrome and color 3270 emulations is included in the 
  213. program (it will recognize either); color emulation is the preferred mode, 
  214. however. 
  215.  
  216.  
  217. Non-Features
  218.  
  219.  
  220.     You may notice that basic file transfer support is included in this version.  
  221. However, it is not even close to functional.  Use at your own risk.  The only 
  222. function it serves currently is the building of the TSO command to initiate the 
  223. file transfer.  If you have some time, you may want to try to decipher what 
  224. IND$FILE responds with.
  225.  
  226.  
  227.     If you have any information that may help to decode this protocol, please let 
  228. me know.  I would like to add this in the near future, but reverse-engineering 
  229. this type of protocol is not a simple task.
  230.  
  231.  
  232.     You may notice that text scrolling with the TTY emulation does not work 
  233. properly when portions of the screen are obscured.  Since this is not a problem 
  234. with standard asynchronous 3270 emulation, the overhead of remedying the 
  235. situation has not been added.
  236.  
  237.  
  238.     Multiple logical unit support (for a local printer) has been added to this version, 
  239. but I have very little faith that it will work as intended.  If someone needs this 
  240. feature and is willing to work with me, please give me a call and we can try to 
  241. get everything working correctly.
  242.  
  243.  
  244. Key Mappings
  245.  
  246.  
  247. 3270 Key    Standard Keyboard    Extended Keyboard
  248.  
  249.  
  250. PF1    Option-1    F1
  251.  
  252. PF2    Option-2    F2
  253.  
  254. PF3    Option-3    F3
  255.  
  256. PF4    Option-4    F4
  257.  
  258. PF5    Option-5    F5
  259.  
  260. PF6    Option-6    F6
  261.  
  262. PF7    Option-7    F7
  263.  
  264. PF8    Option-8    F8
  265.  
  266. PF9    Option-9    F9
  267.  
  268. PF10    Option-0    F10
  269.  
  270. PF11    Option--    F11
  271.  
  272. PF12    Option-=    F12
  273.  
  274. PF13    Command-1    Option-F1
  275.  
  276. PF14    Command-2    Option-F2
  277.  
  278. PF15    Command-3    Option-F3
  279.  
  280. PF16    Command-4    Option-F4
  281.  
  282. PF17    Command-5    Option-F5
  283.  
  284. PF18    Command-6    Option-F6
  285.  
  286. PF19    Command-7    Option-F7
  287.  
  288. PF20    Command-8    Option-F8
  289.  
  290. PF21    Command-9    Option-F9
  291.  
  292. PF22    Command-10    Option-F10
  293.  
  294. PF23    Command--    Option-F11
  295.  
  296. PF24    Command-=    Option-F12
  297.  
  298.  
  299. Tab    Tab    Tab
  300.  
  301. Backtab    Option-Tab    Option-Tab
  302.  
  303. ATTN    Command-A    Command-A
  304.  
  305. Clear    Clear    Clear
  306.  
  307. Enter    Return    Return
  308.  
  309. Home    Option-Cursor Up    Home
  310.  
  311. Left Cursor    Left Cursor    Left Cursor
  312.  
  313. Right Cursor    Right Cursor    Right Cursor    
  314.  
  315. Up Cursor    Up Cursor    Up Cursor
  316.  
  317. Down Cursor    Down Cursor    Down Cursor
  318.  
  319. New Line    Enter (keypad)    Enter (keypad)
  320.  
  321. Insert     Command-I    Command-I
  322.  
  323. Insert (Alternate)    Option-Delete    Option-Help
  324.  
  325. Fwd Delete (x>)    Option-Right Cursor    Fwd Delete (x>)
  326.  
  327. Erase EOF    Command-E    Command-E
  328.  
  329. Reset    Command-R    Command-R
  330.  
  331. Refresh Display    Command-K    Command-K
  332.  
  333.  
  334. PA1    (Menu)    F13
  335.  
  336. PA2    (Menu)    F14
  337.  
  338. PA3    (Menu)    F15
  339.  
  340.  
  341.                                           
  342.  
  343.  
  344. IBM is a registered trademark of International Business Machines.  FTTerm, 3270, IND$FILE, TSO, 
  345. and PC/HOST are trademarks of IBM.  Apple, QuickDraw, Color QuickDraw, APDA, System 7 and 
  346. Communications Toolbox are registered trademarks of Apple Computer, Inc. DEC, VT52, and VT100  
  347. are  trademarks of Digital Equipment Corporation.
  348.  
  349.